+++ /dev/null
-/* GTK - The GIMP Toolkit
- * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
- *
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
- *
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library. If not, see <http://www.gnu.org/licenses/>.
- *
- * GtkLayout: Widget for scrolling of arbitrary-sized areas.
- *
- * Copyright Owen Taylor, 1998
- */
-
-/*
- * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
- * file for a list of people on the GTK+ Team. See the ChangeLog
- * files for a list of changes. These files are distributed with
- * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
- */
-
-#include "config.h"
-
-#include "gtklayout.h"
-
-#include "gdk/gdk.h"
-
-#include "gtkadjustment.h"
-#include "gtkintl.h"
-#include "gtkmarshalers.h"
-#include "gtkprivate.h"
-#include "gtkscrollable.h"
-
-
-/**
- * SECTION:gtklayout
- * @Short_description: Infinite scrollable area containing child widgets
- * and/or custom drawing
- * @Title: GtkLayout
- * @See_also: #GtkDrawingArea, #GtkFixed
- *
- * #GtkLayout is similar to #GtkDrawingArea in that it’s a “blank slate” and
- * doesn’t do anything except paint a blank background by default. It’s
- * different in that it supports scrolling natively due to implementing
- * #GtkScrollable, and can contain child widgets since it’s a #GtkContainer.
- *
- * If you just want to draw, a #GtkDrawingArea is a better choice since it has
- * lower overhead. If you just need to position child widgets at specific
- * points, then #GtkFixed provides that functionality on its own.
- */
-
-
-typedef struct _LayoutChild LayoutChild;
-
-typedef struct
-{
- /* Properties */
- guint width;
- guint height;
-
- GtkAdjustment *hadjustment;
- GtkAdjustment *vadjustment;
-
- /* GtkScrollablePolicy needs to be checked when
- * driving the scrollable adjustment values */
- guint hscroll_policy : 1;
- guint vscroll_policy : 1;
-
- /* Properties */
- GList *children;
-} GtkLayoutPrivate;
-
-struct _LayoutChild {
- GtkWidget *widget;
- gint x;
- gint y;
-};
-
-enum {
- PROP_0,
- PROP_HADJUSTMENT,
- PROP_VADJUSTMENT,
- PROP_HSCROLL_POLICY,
- PROP_VSCROLL_POLICY,
- PROP_WIDTH,
- PROP_HEIGHT
-};
-
-enum {
- CHILD_PROP_0,
- CHILD_PROP_X,
- CHILD_PROP_Y
-};
-
-static void gtk_layout_get_property (GObject *object,
- guint prop_id,
- GValue *value,
- GParamSpec *pspec);
-static void gtk_layout_set_property (GObject *object,
- guint prop_id,
- const GValue *value,
- GParamSpec *pspec);
-static void gtk_layout_finalize (GObject *object);
-static void gtk_layout_measure (GtkWidget *widget,
- GtkOrientation orientation,
- int for_size,
- int *minimum,
- int *natural,
- int *minimum_baseline,
- int *natural_baseline);
-static void gtk_layout_size_allocate (GtkWidget *widget,
- int width,
- int height,
- int baseline);
-static void gtk_layout_add (GtkContainer *container,
- GtkWidget *widget);
-static void gtk_layout_remove (GtkContainer *container,
- GtkWidget *widget);
-static void gtk_layout_forall (GtkContainer *container,
- GtkCallback callback,
- gpointer callback_data);
-static void gtk_layout_set_child_property (GtkContainer *container,
- GtkWidget *child,
- guint property_id,
- const GValue *value,
- GParamSpec *pspec);
-static void gtk_layout_get_child_property (GtkContainer *container,
- GtkWidget *child,
- guint property_id,
- GValue *value,
- GParamSpec *pspec);
-static void gtk_layout_adjustment_changed (GtkAdjustment *adjustment,
- GtkWidget *widget);
-
-static void gtk_layout_set_hadjustment_values (GtkLayout *layout);
-static void gtk_layout_set_vadjustment_values (GtkLayout *layout);
-
-G_DEFINE_TYPE_WITH_CODE (GtkLayout, gtk_layout, GTK_TYPE_CONTAINER,
- G_ADD_PRIVATE (GtkLayout)
- G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL))
-
-/* Public interface
- */
-/**
- * gtk_layout_new:
- * @hadjustment: (allow-none): horizontal scroll adjustment, or %NULL
- * @vadjustment: (allow-none): vertical scroll adjustment, or %NULL
- *
- * Creates a new #GtkLayout. Unless you have a specific adjustment
- * you’d like the layout to use for scrolling, pass %NULL for
- * @hadjustment and @vadjustment.
- *
- * Returns: a new #GtkLayout
- **/
-
-GtkWidget*
-gtk_layout_new (GtkAdjustment *hadjustment,
- GtkAdjustment *vadjustment)
-{
- GtkLayout *layout;
-
- layout = g_object_new (GTK_TYPE_LAYOUT,
- "hadjustment", hadjustment,
- "vadjustment", vadjustment,
- NULL);
-
- return GTK_WIDGET (layout);
-}
-
-static void
-gtk_layout_set_hadjustment_values (GtkLayout *layout)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- GtkAllocation allocation;
- GtkAdjustment *adj = priv->hadjustment;
- gdouble old_value;
- gdouble new_value;
- gdouble new_upper;
-
- gtk_widget_get_allocation (GTK_WIDGET (layout), &allocation);
-
- old_value = gtk_adjustment_get_value (adj);
- new_upper = MAX (allocation.width, priv->width);
-
- g_object_set (adj,
- "lower", 0.0,
- "upper", new_upper,
- "page-size", (gdouble)allocation.width,
- "step-increment", allocation.width * 0.1,
- "page-increment", allocation.width * 0.9,
- NULL);
-
- new_value = CLAMP (old_value, 0, new_upper - allocation.width);
- if (new_value != old_value)
- gtk_adjustment_set_value (adj, new_value);
-}
-
-static void
-gtk_layout_set_vadjustment_values (GtkLayout *layout)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- GtkAllocation allocation;
- GtkAdjustment *adj = priv->vadjustment;
- gdouble old_value;
- gdouble new_value;
- gdouble new_upper;
-
- gtk_widget_get_allocation (GTK_WIDGET (layout), &allocation);
-
- old_value = gtk_adjustment_get_value (adj);
- new_upper = MAX (allocation.height, priv->height);
-
- g_object_set (adj,
- "lower", 0.0,
- "upper", new_upper,
- "page-size", (gdouble)allocation.height,
- "step-increment", allocation.height * 0.1,
- "page-increment", allocation.height * 0.9,
- NULL);
-
- new_value = CLAMP (old_value, 0, new_upper - allocation.height);
- if (new_value != old_value)
- gtk_adjustment_set_value (adj, new_value);
-}
-
-static void
-gtk_layout_finalize (GObject *object)
-{
- GtkLayout *layout = GTK_LAYOUT (object);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- g_object_unref (priv->hadjustment);
- g_object_unref (priv->vadjustment);
-
- G_OBJECT_CLASS (gtk_layout_parent_class)->finalize (object);
-}
-
-static void
-gtk_layout_set_hadjustment (GtkLayout *layout,
- GtkAdjustment *adjustment)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- if (adjustment && priv->hadjustment == adjustment)
- return;
-
- if (priv->hadjustment != NULL)
- {
- g_signal_handlers_disconnect_by_func (priv->hadjustment,
- gtk_layout_adjustment_changed,
- layout);
- g_object_unref (priv->hadjustment);
- }
-
- if (adjustment == NULL)
- adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
-
- g_signal_connect (adjustment, "value-changed",
- G_CALLBACK (gtk_layout_adjustment_changed), layout);
- priv->hadjustment = g_object_ref_sink (adjustment);
- gtk_layout_set_hadjustment_values (layout);
-
- g_object_notify (G_OBJECT (layout), "hadjustment");
-}
-
-static void
-gtk_layout_set_vadjustment (GtkLayout *layout,
- GtkAdjustment *adjustment)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- if (adjustment && priv->vadjustment == adjustment)
- return;
-
- if (priv->vadjustment != NULL)
- {
- g_signal_handlers_disconnect_by_func (priv->vadjustment,
- gtk_layout_adjustment_changed,
- layout);
- g_object_unref (priv->vadjustment);
- }
-
- if (adjustment == NULL)
- adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
-
- g_signal_connect (adjustment, "value-changed",
- G_CALLBACK (gtk_layout_adjustment_changed), layout);
- priv->vadjustment = g_object_ref_sink (adjustment);
- gtk_layout_set_vadjustment_values (layout);
-
- g_object_notify (G_OBJECT (layout), "vadjustment");
-}
-
-static LayoutChild *
-get_child (GtkLayout *layout,
- GtkWidget *widget)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- GList *children;
-
- children = priv->children;
- while (children)
- {
- LayoutChild *child;
-
- child = children->data;
- children = children->next;
-
- if (child->widget == widget)
- return child;
- }
-
- return NULL;
-}
-
-/**
- * gtk_layout_put:
- * @layout: a #GtkLayout
- * @child_widget: child widget
- * @x: X position of child widget
- * @y: Y position of child widget
- *
- * Adds @child_widget to @layout, at position (@x,@y).
- * @layout becomes the new parent container of @child_widget.
- *
- **/
-void
-gtk_layout_put (GtkLayout *layout,
- GtkWidget *child_widget,
- gint x,
- gint y)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- LayoutChild *child;
-
- g_return_if_fail (GTK_IS_LAYOUT (layout));
- g_return_if_fail (GTK_IS_WIDGET (child_widget));
-
- child = g_new (LayoutChild, 1);
-
- child->widget = child_widget;
- child->x = x;
- child->y = y;
-
- priv->children = g_list_append (priv->children, child);
-
- gtk_widget_set_parent (child_widget, GTK_WIDGET (layout));
-}
-
-static void
-gtk_layout_move_internal (GtkLayout *layout,
- GtkWidget *widget,
- gboolean change_x,
- gint x,
- gboolean change_y,
- gint y)
-{
- LayoutChild *child;
-
- child = get_child (layout, widget);
-
- g_assert (child);
-
- gtk_widget_freeze_child_notify (widget);
-
- if (change_x)
- {
- child->x = x;
- gtk_widget_child_notify (widget, "x");
- }
-
- if (change_y)
- {
- child->y = y;
- gtk_widget_child_notify (widget, "y");
- }
-
- gtk_widget_thaw_child_notify (widget);
-
- if (gtk_widget_get_visible (widget) &&
- gtk_widget_get_visible (GTK_WIDGET (layout)))
- gtk_widget_queue_resize (widget);
-}
-
-/**
- * gtk_layout_move:
- * @layout: a #GtkLayout
- * @child_widget: a current child of @layout
- * @x: X position to move to
- * @y: Y position to move to
- *
- * Moves a current child of @layout to a new position.
- *
- **/
-void
-gtk_layout_move (GtkLayout *layout,
- GtkWidget *child_widget,
- gint x,
- gint y)
-{
- g_return_if_fail (GTK_IS_LAYOUT (layout));
- g_return_if_fail (GTK_IS_WIDGET (child_widget));
- g_return_if_fail (gtk_widget_get_parent (child_widget) == GTK_WIDGET (layout));
-
- gtk_layout_move_internal (layout, child_widget, TRUE, x, TRUE, y);
-}
-
-/**
- * gtk_layout_set_size:
- * @layout: a #GtkLayout
- * @width: width of entire scrollable area
- * @height: height of entire scrollable area
- *
- * Sets the size of the scrollable area of the layout.
- *
- **/
-void
-gtk_layout_set_size (GtkLayout *layout,
- guint width,
- guint height)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- g_return_if_fail (GTK_IS_LAYOUT (layout));
-
- g_object_freeze_notify (G_OBJECT (layout));
- if (width != priv->width)
- {
- priv->width = width;
- g_object_notify (G_OBJECT (layout), "width");
- }
- if (height != priv->height)
- {
- priv->height = height;
- g_object_notify (G_OBJECT (layout), "height");
- }
- g_object_thaw_notify (G_OBJECT (layout));
-
- gtk_layout_set_hadjustment_values (layout);
- gtk_layout_set_vadjustment_values (layout);
-}
-
-/**
- * gtk_layout_get_size:
- * @layout: a #GtkLayout
- * @width: (out) (allow-none): location to store the width set on
- * @layout, or %NULL
- * @height: (out) (allow-none): location to store the height set on
- * @layout, or %NULL
- *
- * Gets the size that has been set on the layout, and that determines
- * the total extents of the layout’s scrollbar area. See
- * gtk_layout_set_size ().
- **/
-void
-gtk_layout_get_size (GtkLayout *layout,
- guint *width,
- guint *height)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- g_return_if_fail (GTK_IS_LAYOUT (layout));
-
- if (width)
- *width = priv->width;
- if (height)
- *height = priv->height;
-}
-
-/* Basic Object handling procedures
- */
-static void
-gtk_layout_class_init (GtkLayoutClass *class)
-{
- GObjectClass *gobject_class;
- GtkWidgetClass *widget_class;
- GtkContainerClass *container_class;
-
- gobject_class = (GObjectClass*) class;
- widget_class = (GtkWidgetClass*) class;
- container_class = (GtkContainerClass*) class;
-
- gobject_class->set_property = gtk_layout_set_property;
- gobject_class->get_property = gtk_layout_get_property;
- gobject_class->finalize = gtk_layout_finalize;
-
- container_class->set_child_property = gtk_layout_set_child_property;
- container_class->get_child_property = gtk_layout_get_child_property;
-
- gtk_container_class_install_child_property (container_class,
- CHILD_PROP_X,
- g_param_spec_int ("x",
- P_("X position"),
- P_("X position of child widget"),
- G_MININT,
- G_MAXINT,
- 0,
- GTK_PARAM_READWRITE));
-
- gtk_container_class_install_child_property (container_class,
- CHILD_PROP_Y,
- g_param_spec_int ("y",
- P_("Y position"),
- P_("Y position of child widget"),
- G_MININT,
- G_MAXINT,
- 0,
- GTK_PARAM_READWRITE));
-
- /* Scrollable interface */
- g_object_class_override_property (gobject_class, PROP_HADJUSTMENT, "hadjustment");
- g_object_class_override_property (gobject_class, PROP_VADJUSTMENT, "vadjustment");
- g_object_class_override_property (gobject_class, PROP_HSCROLL_POLICY, "hscroll-policy");
- g_object_class_override_property (gobject_class, PROP_VSCROLL_POLICY, "vscroll-policy");
-
- g_object_class_install_property (gobject_class,
- PROP_WIDTH,
- g_param_spec_uint ("width",
- P_("Width"),
- P_("The width of the layout"),
- 0,
- G_MAXINT,
- 100,
- GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
- g_object_class_install_property (gobject_class,
- PROP_HEIGHT,
- g_param_spec_uint ("height",
- P_("Height"),
- P_("The height of the layout"),
- 0,
- G_MAXINT,
- 100,
- GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
- widget_class->measure = gtk_layout_measure;
- widget_class->size_allocate = gtk_layout_size_allocate;
-
- container_class->add = gtk_layout_add;
- container_class->remove = gtk_layout_remove;
- container_class->forall = gtk_layout_forall;
-}
-
-static void
-gtk_layout_get_property (GObject *object,
- guint prop_id,
- GValue *value,
- GParamSpec *pspec)
-{
- GtkLayout *layout = GTK_LAYOUT (object);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- switch (prop_id)
- {
- case PROP_HADJUSTMENT:
- g_value_set_object (value, priv->hadjustment);
- break;
- case PROP_VADJUSTMENT:
- g_value_set_object (value, priv->vadjustment);
- break;
- case PROP_HSCROLL_POLICY:
- g_value_set_enum (value, priv->hscroll_policy);
- break;
- case PROP_VSCROLL_POLICY:
- g_value_set_enum (value, priv->vscroll_policy);
- break;
- case PROP_WIDTH:
- g_value_set_uint (value, priv->width);
- break;
- case PROP_HEIGHT:
- g_value_set_uint (value, priv->height);
- break;
- default:
- G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
- break;
- }
-}
-
-static void
-gtk_layout_set_property (GObject *object,
- guint prop_id,
- const GValue *value,
- GParamSpec *pspec)
-{
- GtkLayout *layout = GTK_LAYOUT (object);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- switch (prop_id)
- {
- case PROP_HADJUSTMENT:
- gtk_layout_set_hadjustment (layout, g_value_get_object (value));
- break;
- case PROP_VADJUSTMENT:
- gtk_layout_set_vadjustment (layout, g_value_get_object (value));
- break;
- case PROP_HSCROLL_POLICY:
- if (priv->hscroll_policy != g_value_get_enum (value))
- {
- priv->hscroll_policy = g_value_get_enum (value);
- gtk_widget_queue_resize (GTK_WIDGET (layout));
- g_object_notify_by_pspec (object, pspec);
- }
- break;
- case PROP_VSCROLL_POLICY:
- if (priv->vscroll_policy != g_value_get_enum (value))
- {
- priv->vscroll_policy = g_value_get_enum (value);
- gtk_widget_queue_resize (GTK_WIDGET (layout));
- g_object_notify_by_pspec (object, pspec);
- }
- break;
- case PROP_WIDTH:
- gtk_layout_set_size (layout, g_value_get_uint (value), priv->height);
- break;
- case PROP_HEIGHT:
- gtk_layout_set_size (layout, priv->width, g_value_get_uint (value));
- break;
- default:
- G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
- break;
- }
-}
-
-static void
-gtk_layout_set_child_property (GtkContainer *container,
- GtkWidget *child,
- guint property_id,
- const GValue *value,
- GParamSpec *pspec)
-{
- switch (property_id)
- {
- case CHILD_PROP_X:
- gtk_layout_move_internal (GTK_LAYOUT (container),
- child,
- TRUE, g_value_get_int (value),
- FALSE, 0);
- break;
- case CHILD_PROP_Y:
- gtk_layout_move_internal (GTK_LAYOUT (container),
- child,
- FALSE, 0,
- TRUE, g_value_get_int (value));
- break;
- default:
- GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
- break;
- }
-}
-
-static void
-gtk_layout_get_child_property (GtkContainer *container,
- GtkWidget *child,
- guint property_id,
- GValue *value,
- GParamSpec *pspec)
-{
- LayoutChild *layout_child;
-
- layout_child = get_child (GTK_LAYOUT (container), child);
-
- switch (property_id)
- {
- case CHILD_PROP_X:
- g_value_set_int (value, layout_child->x);
- break;
- case CHILD_PROP_Y:
- g_value_set_int (value, layout_child->y);
- break;
- default:
- GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
- break;
- }
-}
-
-static void
-gtk_layout_init (GtkLayout *layout)
-{
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
-
- gtk_widget_set_has_surface (GTK_WIDGET (layout), FALSE);
-
- priv->children = NULL;
-
- priv->width = 100;
- priv->height = 100;
-
- priv->hadjustment = NULL;
- priv->vadjustment = NULL;
-}
-
-static void
-gtk_layout_measure (GtkWidget *widget,
- GtkOrientation orientation,
- int for_size,
- int *minimum,
- int *natural,
- int *minimum_baseline,
- int *natural_baseline)
-{
- *minimum = *natural = 0;
-}
-
-
-static void
-gtk_layout_size_allocate (GtkWidget *widget,
- int width,
- int height,
- int baseline)
-{
- GtkLayout *layout = GTK_LAYOUT (widget);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- GList *tmp_list;
- int scroll_x = 0;
- int scroll_y = 0;
-
- tmp_list = priv->children;
-
- if (priv->hadjustment)
- scroll_x = - gtk_adjustment_get_value (priv->hadjustment);
-
- if (priv->vadjustment)
- scroll_y = - gtk_adjustment_get_value (priv->vadjustment);
-
- while (tmp_list)
- {
- LayoutChild *child = tmp_list->data;
- GtkAllocation allocation;
- GtkRequisition requisition;
-
- tmp_list = tmp_list->next;
-
- allocation.x = child->x + scroll_x;
- allocation.y = child->y + scroll_y;
-
- gtk_widget_get_preferred_size (child->widget, &requisition, NULL);
- allocation.width = requisition.width;
- allocation.height = requisition.height;
-
- gtk_widget_size_allocate (child->widget, &allocation, -1);
- }
-
- gtk_layout_set_hadjustment_values (layout);
- gtk_layout_set_vadjustment_values (layout);
-}
-
-/* Container methods
- */
-static void
-gtk_layout_add (GtkContainer *container,
- GtkWidget *widget)
-{
- gtk_layout_put (GTK_LAYOUT (container), widget, 0, 0);
-}
-
-static void
-gtk_layout_remove (GtkContainer *container,
- GtkWidget *widget)
-{
- GtkLayout *layout = GTK_LAYOUT (container);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- GList *tmp_list;
- LayoutChild *child = NULL;
-
- tmp_list = priv->children;
- while (tmp_list)
- {
- child = tmp_list->data;
- if (child->widget == widget)
- break;
- tmp_list = tmp_list->next;
- }
-
- if (tmp_list)
- {
- gtk_widget_unparent (widget);
-
- priv->children = g_list_remove_link (priv->children, tmp_list);
- g_list_free_1 (tmp_list);
- g_free (child);
- }
-}
-
-static void
-gtk_layout_forall (GtkContainer *container,
- GtkCallback callback,
- gpointer callback_data)
-{
- GtkLayout *layout = GTK_LAYOUT (container);
- GtkLayoutPrivate *priv = gtk_layout_get_instance_private (layout);
- LayoutChild *child;
- GList *tmp_list;
-
- tmp_list = priv->children;
- while (tmp_list)
- {
- child = tmp_list->data;
- tmp_list = tmp_list->next;
-
- (* callback) (child->widget, callback_data);
- }
-}
-
-/* Callbacks */
-
-static void
-gtk_layout_adjustment_changed (GtkAdjustment *adjustment,
- GtkWidget *layout)
-{
- gtk_widget_queue_allocate (layout);
-}
projects / gtk4.git / commitdiff